home *** CD-ROM | disk | FTP | other *** search
- <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
- <html> <head>
- <title>Readme for analog -- quick reference</title>
- </head>
-
- <body>
- [ <a href="Readme.html">Top</a> | Up | Prev | Next |
- <a href="map.html">Map</a> | <a href="indx.html">Index</a> ]
- <h1>Readme for
- <a href="http://www.statslab.cam.ac.uk/~sret1/analog/">analog 4.03</a></h1>
- <h2>Quick reference</h2>
-
- This section is list of all of analog's configuration commands, together with a
- quick reference to their syntax and some examples. It's designed for those who
- are already familiar with the program, so it's pretty useless for trying to
- learn the program: to learn about the commands, read the section on
- <cite><a href="custom.html">Customising analog</a></cite> instead, or consult
- the <a href="indx.html">index</a> for a reference. I would
- <a href="mailing.html">welcome feedback</a> on this new section.
-
- <p>
- This section is divided into the following parts:
- <ul>
- <li><a href="#quicknot">Notation</a>
- <li><a href="#quickfiles">Input and output files</a>
- <li><a href="#quickfmt"><kbd>LOGFORMAT</kbd> commands</a>
- <li><a href="#quickalias"><kbd>ALIAS</kbd> commands</a>
- <li><a href="#quickinclude"><kbd>INCLUDE/EXCLUDE</kbd> commands</a>
- <li><a href="#quickdns">DNS commands</a>
- <li><a href="#quicksub">Sub-item commands</a>
- <li><a href="#quicklowmem"><kbd>LOWMEM</kbd> commands</a>
- <li><a href="#quickrep">Report commands</a>
- <li><a href="#quickgraph"><kbd>GRAPH</kbd> commands</a>
- <li><a href="#quickback"><kbd>BACK</kbd> commands</a>
- <li><a href="#quickrows"><kbd>ROWS</kbd> commands</a>
- <li><a href="#quickcols"><kbd>COLS</kbd> commands</a>
- <li><a href="#quicksortby"><kbd>SORTBY</kbd> commands</a>
- <li><a href="#quickfloor"><kbd>FLOOR</kbd> commands</a>
- <li><a href="#quicklinks">Hyperlinks</a>
- <li><a href="#quicklang">Language commands</a>
- <li><a href="#quickcosmetic">Cosmetic and miscellaneous commands</a>
- <li><a href="#quickdebug">Diagnostics</a>
- </ul>
-
- <h3><a name="quicknot">Notation</a></h3>
- The syntax for each command is given using the following notation.
- <pre>
- "stuff" the word stuff
- x y x followed by y
- (x | y) x or y
- [x] optional x
- subset("...") any letters from the string, in any order
- perm("...") all the letters from the string, in any order
- *x x may contain wildcards * and ? (and often comma-separated list)
- x := y x is defined to be y
- COMMAND the command under discussion
- </pre>
- In addition, I use the following names for different types of argument.
- <pre>
- char a single character
- string a string
- digit a digit
- number a non-negative integer (i.e. a string of digits)
- real a non-negative real number
- regexp a POSIX extended regular expression
- file a filename within your server's filespace;
- e.g. /index.html
- localfile a filename within your system's filespace;
- e.g. /usr/local/analog.html
- localfmtfile as localfile, but may contain <a href="output.html#OUTFILE">date codes</a>;
- e.g. /usr/local/analog%y%M.html
- referrer a URL of a referring page;
- e.g. http://search.yahoo.com/
- URL a URL which may be absolute, or relative to the output page;
- e.g. images/ or /~fred/images/
- or http://www.fred.com/images/
- </pre>
-
- <p>Note: I have occasionally opted for clarity above strict accuracy where I
- don't think it will cause any confusion!
-
- <p>The syntax for commands in general was given
- <a href="syntax.html">earlier</a>: remember that an argument which contains a
- hash or a space must be put in quotes or parentheses.
-
- <h3><a name="quickfiles">Input and output files</a></h3>
-
- <dl>
- <dt><i>Syntax</i>
- <dd><kbd>
- <a href="logfile.html">LOGFILE</a> (*localfile | "-" | "none") [prefix_string]
- <br><a href="output.html#OUTFILE">OUTFILE</a> (localfmtfile | "-" | "none")
- <br><a href="cache.html">CACHEFILE</a> (*localfile | "-" | "none")
- <br><a href="cache.html">CACHEOUTFILE</a> (localfmtfile | "-" | "none")
- <br><a href="logfile.html#UNCOMPRESS">UNCOMPRESS</a> *localfile program
- </kbd>
- <dt><i>Examples</i>
- <dd><kbd>
- LOGFILE /httpd/logs/*
- <br>LOGFILE c:\logs\log1,c:\logs\log2
- <br>OUTFILE "Hard Disk:Report%Y%M.html"
- <br>UNCOMPRESS *.gz "/usr/bin/gzip -cd"</kbd>
- </dl>
-
- <h3><a name="quickfmt"><kbd>LOGFORMAT</kbd> commands</a></h3>
-
- <dl>
- <dt><i>Syntax</i>
- <dd><pre>
- format_string := (<a href="logfmt.html#fmtstrings">see documentation</a>)
- Apache_format_string := (see <a href="http://www.apache.org/docs/mod/mod_log_config.html">Apache documentation</a>)
- logformat := ("COMMON" | "COMBINED" | "REFERRER" | "BROWSER" | "EXTENDED" |
- "MICROSOFT-NA" | "MICROSOFT-INT" | "WEBSITE-NA" | "WEBSITE-INT" |
- "MS-EXTENDED" | "MS-COMMON" | "NETSCAPE" | "WEBSTAR" | "AUTO" |
- format_string)
- <a href="logfmt.html">LOGFORMAT</a> logformat
- <a href="logfmt.html#DEFAULTLOGFORMAT">DEFAULTLOGFORMAT</a> logformat
- <a href="logfmt.html#Apache">APACHELOGFORMAT</a> Apache_format_string
- <a href="logfmt.html#DEFAULTLOGFORMAT">APACHEDEFAULTLOGFORMAT</a> Apache_format_string
- </pre>
-
- <dt><i>Notes</i>
- <dd><kbd>LOGFORMAT</kbd> and <kbd>APACHELOGFORMAT</kbd> only affect logfiles
- occurring later in the same configuration file.
-
- <dt><i>Examples</i>
- <dd><kbd>
- LOGFORMAT (%S - %u [%d/%M/%Y:%h:%n:%j %j] "%j %r %j" %c %b)
- <br>DEFAULTLOGFORMAT MS-EXTENDED
- <br>APACHELOGFORMAT (%h %l %u %t \"%r\" %s %b)</kbd>
- </dl>
-
-
- <h3><a name="quickalias"><kbd>ALIAS</kbd> commands</a></h3>
-
- <dl>
- <dt><i>1. Commands (items)</i>
- <dd><kbd>
- <a href="alias.html#useraliases">FILEALIAS</a>,
- <a href="alias.html#useraliases">HOSTALIAS</a>,
- <a href="alias.html#useraliases">BROWALIAS</a>,
- <a href="alias.html#useraliases">REFALIAS</a>,
- <a href="alias.html#useraliases">USERALIAS</a>,
- <a href="alias.html#useraliases">VHOSTALIAS</a></kbd>
-
- <dt><i>Syntax</i>
- <dd><kbd>
- COMMAND *olditem newitem
- <br>COMMAND ("REGEXP:" | "REGEXPI:")regexp newitem</kbd>
-
- <dt><i>Notes</i>
- <dd>Aliases item in all reports. Items with the same resultant name are
- combined. <kbd>newitem</kbd> may contain <kbd>$1</kbd>, <kbd>$2</kbd>
- etc., representing the <kbd>*</kbd>'s in <kbd>olditem</kbd> or the
- bracketed subexpressions in <kbd>regexp</kbd>. Regular expressions are only
- available on some platforms.
-
- <dt><i>Examples</i>
- <dd><kbd>FILEALIAS /*/football/* /$1/soccer/$2</kbd>
- <dd><kbd>USERALIAS REGEXP:^([^U].*) U$1</kbd>
-
- <p><dt><i>2. Commands (reports)</i>
- <dd><kbd>
- <a href="alias.html#OUTPUTALIAS">TYPEOUTPUTALIAS</a>,
- <a href="alias.html#OUTPUTALIAS">HOSTOUTPUTALIAS</a>,
- <a href="alias.html#OUTPUTALIAS">REQOUTPUTALIAS</a>,
- <a href="alias.html#OUTPUTALIAS">REDIROUTPUTALIAS</a>,
- <a href="alias.html#OUTPUTALIAS">FAILOUTPUTALIAS</a>,
- <a href="alias.html#OUTPUTALIAS">DIROUTPUTALIAS</a>,
- <a href="alias.html#OUTPUTALIAS">DOMOUTPUTALIAS</a>,
- <a href="alias.html#OUTPUTALIAS">ORGOUTPUTALIAS</a>,
- <a href="alias.html#OUTPUTALIAS">REFOUTPUTALIAS</a>,
- <a href="alias.html#OUTPUTALIAS">REFSITEOUTPUTALIAS</a>,
- <a href="alias.html#OUTPUTALIAS">REDIRREFOUTPUTALIAS</a>,
- <a href="alias.html#OUTPUTALIAS">FAILREFOUTPUTALIAS</a>,
- <a href="alias.html#OUTPUTALIAS">BROWOUTPUTALIAS</a>,
- <a href="alias.html#OUTPUTALIAS">FULLBROWOUTPUTALIAS</a>,
- <a href="alias.html#OUTPUTALIAS">OSOUTPUTALIAS</a>,
- <a href="alias.html#OUTPUTALIAS">VHOSTOUTPUTALIAS</a>,
- <a href="alias.html#OUTPUTALIAS">USEROUTPUTALIAS</a>,
- <a href="alias.html#OUTPUTALIAS">FAILUSEROUTPUTALIAS</a></kbd>
-
- <dt><i>Syntax</i>
- <dd><kbd>
- COMMAND *item string
- <br>COMMAND ("REGEXP:" | "REGEXPI:")regexp string</kbd>
-
- <dt><i>Notes</i>
- <dd>Aliases item on one line of one report only. <kbd>string</kbd> may contain
- <kbd>$1</kbd>, <kbd>$2</kbd> etc., representing the <kbd>*</kbd>'s in
- <kbd>item</kbd> or the bracketed subexpressions in
- <kbd>regexp</kbd>. Regular expressions are only available on some
- platforms.
-
- <dt><i>Examples</i>
- <dd><kbd>REQOUTPUTALIAS /football/ "/football/ (Main football page)"</kbd>
- <dd><kbd>REFOUTPUTALIAS REGEXP:^(http://([^/]*\.)?(maths|stats)\.uxy\.edu.*) ([$3] $1)</kbd>
-
- <p><dt><i>3. Other commands: syntax</i>
- <dd><kbd>
- <a href="alias.html#CASE">CASE</a> ("SENSITIVE" | "INSENSITIVE")
- <br><a href="alias.html#CASE">USERCASE</a> ("SENSITIVE" | "INSENSITIVE")
- <br><a href="args.html#SCC">SEARCHCHARCONVERT</a> ("ON" | "OFF")
- <br><a href="alias.html#DIRSUFFIX">DIRSUFFIX</a> suffix
- <br><a href="output.html#TIMEOFFSET">LOGTIMEOFFSET</a> ["+" | "-"] number
- <br><a href="output.html#TIMEOFFSET">TIMEOFFSET</a> ["+" | "-"] number</kbd>
- <dt><i>Examples</i>
- <dd><kbd>
- CASE SENSITIVE
- <br>DIRSUFFIX index.htm
- <br>LOGTIMEOFFSET -300
- </kbd>
- </dl>
-
-
- <h3><a name="quickinclude"><kbd>INCLUDE/EXCLUDE</kbd> commands</a></h3>
-
- <dl>
- <dt><i>1. Commands (items)</i>
- <dd><kbd>
- <a href="include.html">FILEINCLUDE</a>,
- <a href="include.html">FILEEXCLUDE</a>,
- <a href="include.html">HOSTINCLUDE</a>,
- <a href="include.html">HOSTEXCLUDE</a>,
- <a href="include.html">BROWINCLUDE</a>,
- <a href="include.html">BROWEXCLUDE</a>,
- <a href="include.html">REFINCLUDE</a>,
- <a href="include.html">REFEXCLUDE</a>,
- <a href="include.html">USERINCLUDE</a>,
- <a href="include.html">USEREXCLUDE</a>,
- <a href="include.html">VHOSTINCLUDE</a>,
- <a href="include.html">VHOSTEXCLUDE</a></kbd>
-
- <dt><i>Syntax</i>
- <dd><kbd>
- COMMAND (*item | "")
- <br>COMMAND ("REGEXP:" | "REGEXPI:")regexp</kbd>
-
- <dt><i>Notes</i>
- <dd>Excludes all logfile entries containing an excluded item from all reports.
- Includes and excludes are done after aliases, so the <kbd>item</kbd> is the
- aliased name, if applicable. Regular expressions are only available on some
- platforms.
-
- <dt><i>Examples</i>
- <dd><kbd>
- FILEINCLUDE /jim/*
- <br>FILEINCLUDE REGEXP:^/~[^/]*/$
- <br>HOSTEXCLUDE proxy*.aol.com
- <br>USEREXCLUDE ""
- </kbd>
-
- <p><dt><i>2. Syntax (including and excluding dates)</i>
- <dd><kbd>
- partdate := ["+" | "-"] digit digit
- <br>date := partdate partdate partdate [":" partdate partdate]
- <br><a href="include.html#FROMTO">FROM</a> date
- <br><a href="include.html#FROMTO">TO</a> date</kbd>
- <dt><i>Examples</i>
- <dd><kbd>
- FROM 990719:1200
- <br>TO -00-0101
- </kbd>
-
- <p><dt><i>3. Commands (reports)</i>
- <dd><kbd>
- <a href="include.html#outputexcludes">REQINCLUDE</a>,
- <a href="include.html#outputexcludes">REQEXCLUDE</a>,
- <a href="include.html#outputexcludes">REDIRINCLUDE</a>,
- <a href="include.html#outputexcludes">REDIREXCLUDE</a>,
- <a href="include.html#outputexcludes">FAILINCLUDE</a>,
- <a href="include.html#outputexcludes">FAILEXCLUDE</a>,
- <a href="include.html#outputexcludes">TYPEINCLUDE</a>,
- <a href="include.html#outputexcludes">TYPEEXCLUDE</a>,
- <a href="include.html#outputexcludes">DIRINCLUDE</a>,
- <a href="include.html#outputexcludes">DIREXCLUDE</a>,
- <a href="include.html#outputexcludes">HOSTREPINCLUDE</a>,
- <a href="include.html#outputexcludes">HOSTREPEXCLUDE</a>,
- <a href="include.html#outputexcludes">DOMINCLUDE</a>,
- <a href="include.html#outputexcludes">DOMEXCLUDE</a>,
- <a href="include.html#outputexcludes">ORGINCLUDE</a>,
- <a href="include.html#outputexcludes">ORGEXCLUDE</a>,
- <a href="include.html#outputexcludes">REFREPINCLUDE</a>,
- <a href="include.html#outputexcludes">REFREPEXCLUDE</a>,
- <a href="include.html#outputexcludes">REFSITEINCLUDE</a>,
- <a href="include.html#outputexcludes">REFSITEEXCLUDE</a>,
- <a href="include.html#outputexcludes">SEARCHQUERYINCLUDE</a>,
- <a href="include.html#outputexcludes">SEARCHQUERYEXCLUDE</a>,
- <a href="include.html#outputexcludes">SEARCHWORDINCLUDE</a>,
- <a href="include.html#outputexcludes">SEARCHWORDEXCLUDE</a>,
- <a href="include.html#outputexcludes">REDIRREFINCLUDE</a>,
- <a href="include.html#outputexcludes">REDIRREFEXCLUDE</a>,
- <a href="include.html#outputexcludes">FAILREFINCLUDE</a>,
- <a href="include.html#outputexcludes">FAILREFEXCLUDE</a>,
- <a href="include.html#outputexcludes">BROWSUMINCLUDE</a>,
- <a href="include.html#outputexcludes">BROWSUMEXCLUDE</a>,
- <a href="include.html#outputexcludes">FULLBROWINCLUDE</a>,
- <a href="include.html#outputexcludes">FULLBROWEXCLUDE</a>,
- <a href="include.html#outputexcludes">OSINCLUDE</a>,
- <a href="include.html#outputexcludes">OSEXCLUDE</a>,
- <a href="include.html#outputexcludes">VHOSTREPINCLUDE</a>,
- <a href="include.html#outputexcludes">VHOSTREPEXCLUDE</a>,
- <a href="include.html#outputexcludes">USERREPINCLUDE</a>,
- <a href="include.html#outputexcludes">USERREPEXCLUDE</a>,
- <a href="include.html#outputexcludes">FAILUSERINCLUDE</a>,
- <a href="include.html#outputexcludes">FAILUSEREXCLUDE</a></kbd>
-
- <dt><i>Syntax</i>
- <dd><kbd>
- COMMAND *item
- <br>COMMAND ("REGEXP:" | "REGEXPI:")regexp</kbd>
-
- <dt><i>Notes</i>
- <dd>Excludes an excluded item from one report only. Regular expressions are
- only available on some platforms.
-
- <dt><i>Example</i>
- <dd><kbd>REQINCLUDE pages</kbd>
-
- <p><dt><i>4. Syntax (miscellaneous)</i>
- <dd><kbd>
- <a href="include.html#PAGEINCLUDE">PAGEINCLUDE</a> *file
- <br><a href="include.html#PAGEINCLUDE">PAGEEXCLUDE</a> *file
- <br><a href="args.html#ARGSINCLUDE">ARGSINCLUDE</a> *file
- <br><a href="args.html#ARGSINCLUDE">ARGSEXCLUDE</a> *file
- <br><a href="args.html#ARGSINCLUDE">REFARGSINCLUDE</a> *referrer
- <br><a href="args.html#ARGSINCLUDE">REFARGSEXCLUDE</a> *referrer</kbd>
- <dt><i>Notes</i>
- <dd>These can be regular expressions too, on suitable platforms.
- <dt><i>Example</i>
- <dd><kbd>
- PAGEINCLUDE *.asp
- </kbd>
- </dl>
-
- <h3><a name="quickdns">DNS commands</a></h3>
-
- <dl>
- <dt><i>Syntax</i>
- <dd><kbd>
- <a href="dns.html">DNSFILE</a> localfile
- <br><a href="dns.html">DNS</a> ("NONE" | "READ" | "LOOKUP" | "WRITE")
- <br><a href="dns.html">DNSLOCKFILE</a> localfile
- <br><a href="dns.html">DNSGOODHOURS</a> number
- <br><a href="dns.html">DNSBADHOURS</a> number</kbd>
- <dt><i>Examples</i>
- <dd><kbd>
- DNSFILE dnscache.txt
- <br>DNS WRITE
- <br>DNSBADHOURS 48
- </kbd>
- </dl>
-
- <h3><a name="quicksub">Sub-item commands</a></h3>
-
- <dl>
- <dt><i>Syntax</i>
- <dd><kbd>
- <a href="hierreps.html">SUBDIR</a> *file
- <br><a href="hierreps.html">SUBDOMAIN</a> *subdomain
- <br><a href="hierreps.html">SUBORG</a> *subdomain
- <br><a href="hierreps.html">SUBTYPE</a> *extension
- <br><a href="hierreps.html">SUBBROW</a> *browser
- <br><a href="hierreps.html">REFDIR</a> *referrer</kbd>
- <dt><i>Examples</i>
- <dd><kbd>
- SUBDIR /jim/*/*
- <br>SUBTYPE *.gz
- </kbd>
- </dl>
-
- <h3><a name="quicklowmem"><kbd>LOWMEM</kbd> commands</a></h3>
-
- <dl>
- <dt><i>Commands</i>
- <dd><kbd><a href="lowmem.html">FILELOWMEM</a>,
- <a href="lowmem.html">HOSTLOWMEM</a>,
- <a href="lowmem.html">BROWLOWMEM</a>,
- <a href="lowmem.html">REFLOWMEM</a>,
- <a href="lowmem.html">USERLOWMEM</a>,
- <a href="lowmem.html">VHOSTLOWMEM</a></kbd>
- <dt><i>Syntax</i>
- <dd><kbd>
- COMMAND ("0" | "1" | "2" | "3")</kbd>
- <dt><i>Example</i>
- <dd><kbd>
- HOSTLOWMEM 3
- </kbd>
- </dl>
-
- <h3><a name="quickrep">Report commands</a></h3>
-
- <dl>
- <dt><i>Commands</i>
- <dd><kbd><a href="output.html#replist">GENERAL</a>,
- <a href="output.html#replist">ALL</a>,
- <a href="output.html#replist">MONTHLY</a>,
- <a href="output.html#replist">WEEKLY</a>,
- <a href="output.html#replist">FULLDAILY</a>,
- <a href="output.html#replist">DAILY</a>,
- <a href="output.html#replist">FULLHOURLY</a>,
- <a href="output.html#replist">HOURLY</a>,
- <a href="output.html#replist">QUARTER</a>,
- <a href="output.html#replist">FIVE</a>,
- <a href="output.html#replist">HOST</a>,
- <a href="output.html#replist">ORGANISATION</a>,
- <a href="output.html#replist">DOMAIN</a>,
- <a href="output.html#replist">REQUEST</a>,
- <a href="output.html#replist">DIRECTORY</a>,
- <a href="output.html#replist">FILETYPE</a>,
- <a href="output.html#replist">SIZE</a>,
- <a href="output.html#replist">PROCTIME</a>,
- <a href="output.html#replist">REDIR</a>,
- <a href="output.html#replist">FAILURE</a>,
- <a href="output.html#replist">REFERRER</a>,
- <a href="output.html#replist">REFSITE</a>,
- <a href="output.html#replist">SEARCHQUERY</a>,
- <a href="output.html#replist">SEARCHWORD</a>,
- <a href="output.html#replist">REDIRREF</a>,
- <a href="output.html#replist">FAILREF</a>,
- <a href="output.html#replist">FULLBROWSER</a>,
- <a href="output.html#replist">BROWSER</a>,
- <a href="output.html#replist">OSREP</a>,
- <a href="output.html#replist">VHOST</a>,
- <a href="output.html#replist">USER</a>,
- <a href="output.html#replist">FAILUSER</a>,
- <a href="output.html#replist">STATUS</a></kbd>
-
- <dt><i>Syntax</i>
- <dd><kbd>
- REPORTCOMMAND ("ON" | "OFF")</kbd>
- <dt><i>Examples</i>
- <dd><kbd>
- ALL OFF
- <br>FULLHOURLY ON
- </kbd>
- </dl>
-
- <h3><a name="quickgraph"><kbd>GRAPH</kbd> commands</a></h3>
-
- <dl>
- <dt><i>Commands</i>
- <dd><kbd><a href="timereps.html#GRAPH">ALLGRAPH</a>,
- <a href="timereps.html#GRAPH">MONTHGRAPH</a>,
- <a href="timereps.html#GRAPH">WEEKGRAPH</a>,
- <a href="timereps.html#GRAPH">DAYGRAPH</a>,
- <a href="timereps.html#GRAPH">FULLDAYGRAPH</a>,
- <a href="timereps.html#GRAPH">HOURGRAPH</a>,
- <a href="timereps.html#GRAPH">FULLHOURGRAPH</a>,
- <a href="timereps.html#GRAPH">QUARTERGRAPH</a>,
- <a href="timereps.html#GRAPH">FIVEGRAPH</a></kbd>
- <dt><i>Syntax</i>
- <dd><kbd>
- COMMAND ("R" | "r" | "P" | "p" | "B" | "b")</kbd>
- <dt><i>Example</i>
- <dd><kbd>
- ALLGRAPH B
- </kbd>
- </dl>
-
- <h3><a name="quickback"><kbd>BACK</kbd> commands</a></h3>
-
- <dl>
- <dt><i>Commands</i>
- <dd><kbd><a href="timereps.html#BACK">ALLBACK</a>,
- <a href="timereps.html#BACK">MONTHBACK</a>,
- <a href="timereps.html#BACK">WEEKBACK</a>,
- <a href="timereps.html#BACK">FULLDAYBACK</a>,
- <a href="timereps.html#BACK">FULLHOURBACK</a>,
- <a href="timereps.html#BACK">QUARTERBACK</a>,
- <a href="timereps.html#BACK">FIVEBACK</a></kbd>
- <dt><i>Syntax</i>
- <dd><kbd>
- COMMAND ("ON" | "OFF")</kbd>
- <dt><i>Example</i>
- <dd><kbd>
- ALLBACK ON
- </kbd>
- </dl>
-
- <h3><a name="quickrows"><kbd>ROWS</kbd> commands</a></h3>
-
- <dl>
- <dt><i>Commands</i>
- <dd><kbd><a href="timereps.html#ROWS">MONTHROWS</a>,
- <a href="timereps.html#ROWS">WEEKROWS</a>,
- <a href="timereps.html#ROWS">FULLDAYROWS</a>,
- <a href="timereps.html#ROWS">FULLHOURROWS</a>,
- <a href="timereps.html#ROWS">QUARTERROWS</a>,
- <a href="timereps.html#ROWS">FIVEROWS</a></kbd>
- <dt><i>Syntax</i>
- <dd><kbd>
- COMMAND number</kbd>
- <dt><i>Example</i>
- <dd><kbd>
- QUARTERROWS 192
- </kbd>
- </dl>
-
- <h3><a name="quickcols"><kbd>COLS</kbd> commands</a></h3>
-
- <dl>
- <dt><i>1. Commands (time reports)</i>
- <dd><kbd>
- <a href="timereps.html#timeCOLS">TIMECOLS</a>,
- <a href="timereps.html#timeCOLS">MONTHCOLS</a>,
- <a href="timereps.html#timeCOLS">WEEKCOLS</a>,
- <a href="timereps.html#timeCOLS">DAYCOLS</a>,
- <a href="timereps.html#timeCOLS">FULLDAYCOLS</a>,
- <a href="timereps.html#timeCOLS">HOURCOLS</a>,
- <a href="timereps.html#timeCOLS">FULLHOURCOLS</a>,
- <a href="timereps.html#timeCOLS">QUARTERCOLS</a>,
- <a href="timereps.html#timeCOLS">FIVECOLS</a></kbd>
- <dt><i>Syntax</i>
- <dd><kbd>cols1 := subset("RrPpBb")
- <br>COMMAND cols1</kbd>
- <dt><i>Example</i>
- <dd><kbd>
- MONTHCOLS bRP
- </kbd>
-
- <p><dt><i>2. Commands (most success reports)</i>
- <dd><kbd>
- <a href="othreps.html#othCOLS">HOSTCOLS</a>,
- <a href="othreps.html#othCOLS">ORGCOLS</a>,
- <a href="othreps.html#othCOLS">DOMCOLS</a>,
- <a href="othreps.html#othCOLS">DIRCOLS</a>,
- <a href="othreps.html#othCOLS">REFCOLS</a>,
- <a href="othreps.html#othCOLS">REFSITECOLS</a>,
- <a href="othreps.html#othCOLS">SEARCHQUERYCOLS</a>,
- <a href="othreps.html#othCOLS">SEARCHWORDCOLS</a>,
- <a href="othreps.html#othCOLS">FULLBROWCOLS</a>,
- <a href="othreps.html#othCOLS">BROWCOLS</a>,
- <a href="othreps.html#othCOLS">OSCOLS</a>,
- <a href="othreps.html#othCOLS">VHOSTCOLS</a>,
- <a href="othreps.html#othCOLS">USERCOLS</a></kbd>
- <dt><i>Syntax</i>
- <dd><kbd>cols2 := subset("NDRrPpBb")
- <br>COMMAND cols2</kbd>
- <dt><i>Example</i>
- <dd><kbd>
- USERCOLS BD
- </kbd>
-
- <p><dt><i>3. Commands (Request and File Type Reports)</i>
- <dd><kbd>
- <a href="othreps.html#othCOLS">REQCOLS</a>,
- <a href="othreps.html#othCOLS">TYPECOLS</a></kbd>
- <dt><i>Syntax</i>
- <dd><kbd>cols3 := subset("NDRrpBb")
- <br>COMMAND cols3</kbd>
- <dt><i>Example</i>
- <dd><kbd>
- TYPECOLS NRb
- </kbd>
-
-
- <p><dt><i>4. Commands (failure, redirection and Status Code reports)</i>
- <dd><kbd>
- <a href="othreps.html#othCOLS">REDIRCOLS</a>,
- <a href="othreps.html#othCOLS">FAILCOLS</a>,
- <a href="othreps.html#othCOLS">REDIRREFCOLS</a>,
- <a href="othreps.html#othCOLS">FAILREFCOLS</a>,
- <a href="othreps.html#othCOLS">FAILUSERCOLS</a>,
- <a href="othreps.html#othCOLS">STATUSCOLS</a></kbd>
- <dt><i>Syntax</i>
- <dd><kbd>cols4 := subset("NDRr")
- <br>COMMAND cols4</kbd>
- <dt><i>Example</i>
- <dd><kbd>
- FAILCOLS D
- </kbd>
-
- <p><dt><i>5. Commands (Size and Processing Time Reports)</i>
- <dd><kbd>
- <a href="othreps.html#othCOLS">SIZECOLS</a>,
- <a href="othreps.html#othCOLS">PROCTIMECOLS</a></kbd>
- <dt><i>Syntax</i>
- <dd><kbd>cols5 := subset("DRrPpBb")
- <br>COMMAND cols5</kbd>
- <dt><i>Example</i>
- <dd><kbd>
- SIZECOLS RB
- </kbd>
-
- </dl>
-
-
- <h3><a name="quicksortby"><kbd>SORTBY</kbd> commands</a></h3>
-
- <dl>
- <dt><i>1. Commands (most success reports)</i>
- <dd><kbd>
- <a href="othreps.html#SORTBY">HOSTSORTBY</a>,
- <a href="othreps.html#SORTBY">ORGSORTBY</a>,
- <a href="othreps.html#SORTBY">DOMSORTBY</a>,
- <a href="othreps.html#SORTBY">DIRSORTBY</a>,
- <a href="othreps.html#SORTBY">REFSORTBY</a>,
- <a href="othreps.html#SORTBY">REFSITESORTBY</a>,
- <a href="othreps.html#SORTBY">SEARCHQUERYSORTBY</a>,
- <a href="othreps.html#SORTBY">SEARCHWORDSORTBY</a>,
- <a href="othreps.html#SORTBY">FULLBROWSORTBY</a>,
- <a href="othreps.html#SORTBY">BROWSORTBY</a>,
- <a href="othreps.html#SORTBY">OSSORTBY</a>,
- <a href="othreps.html#SORTBY">VHOSTSORTBY</a>,
- <a href="othreps.html#SORTBY">USERSORTBY</a>,
- <a href="hierreps.html#SUBSORTBY">SUBDIRSORTBY</a>,
- <a href="hierreps.html#SUBSORTBY">SUBDOMSORTBY</a>,
- <a href="hierreps.html#SUBSORTBY">SUBORGSORTBY</a>,
- <a href="hierreps.html#SUBSORTBY">SUBBROWSORTBY</a>,
- <a href="hierreps.html#ARGSSORTBY">SUBOSSORTBY</a>,
- <a href="hierreps.html#SUBSORTBY">REFDIRSORTBY</a>,
- <a href="hierreps.html#ARGSSORTBY">REFARGSSORTBY</a></kbd>
- <dt><i>Syntax</i>
- <dd><kbd>sortby1 := ("REQUESTS" | "PAGES" | "BYTES" | "DATE" | "ALPHABETICAL" | "RANDOM")
- <br>COMMAND sortby1</kbd>
- <dt><i>Example</i>
- <dd><kbd>
- DOMSORTBY ALPHABETICAL
- </kbd>
-
- <p><dt><i>2. Commands (Request and File Type Reports)</i>
- <dd><kbd>
- <a href="othreps.html#SORTBY">REQSORTBY</a>,
- <a href="othreps.html#SORTBY">TYPESORTBY</a>,
- <a href="hierreps.html#ARGSSORTBY">REQARGSSORTBY</a>,
- <a href="hierreps.html#SUBSORTBY">SUBTYPESORTBY</a></kbd>
- <dt><i>Syntax</i>
- <dd><kbd>sortby2 := ("REQUESTS" | "BYTES" | "DATE" | "ALPHABETICAL" | "RANDOM")
- <br>COMMAND sortby2</kbd>
- <dt><i>Example</i>
- <dd><kbd>
- REQSORTBY REQUESTS
- </kbd>
-
- <p><dt><i>3. Commands (failure, redirection and Status Code reports)</i>
- <dd><kbd>
- <a href="othreps.html#SORTBY">REDIRSORTBY</a>,
- <a href="othreps.html#SORTBY">FAILSORTBY</a>,
- <a href="othreps.html#SORTBY">REDIRREFSORTBY</a>,
- <a href="othreps.html#SORTBY">FAILREFSORTBY</a>,
- <a href="othreps.html#SORTBY">FAILUSERSORTBY</a>,
- <a href="othreps.html#SORTBY">STATUSSORTBY</a>,
- <a href="hierreps.html#ARGSSORTBY">REDIRARGSSORTBY</a>,
- <a href="hierreps.html#ARGSSORTBY">FAILARGSSORTBY</a>,
- <a href="hierreps.html#ARGSSORTBY">REDIRREFARGSSORTBY</a>,
- <a href="hierreps.html#ARGSSORTBY">FAILREFARGSSORTBY</a></kbd>
- <dt><i>Syntax</i>
- <dd><kbd>sortby3 := ("REQUESTS" | "DATE" | "ALPHABETICAL" | "RANDOM")
- <br>COMMAND sortby3</kbd>
- <dt><i>Example</i>
- <dd><kbd>
- FAILSORTBY DATE
- </kbd>
- </dl>
-
- <h3><a name="quickfloor"><kbd>FLOOR</kbd> commands</a></h3>
-
- <dl>
- <dt><i>Commands (top-level)</i>
- <dd><kbd>
- <a href="othreps.html#FLOOR">HOSTFLOOR</a>,
- <a href="othreps.html#FLOOR">ORGFLOOR</a>,
- <a href="othreps.html#FLOOR">DOMFLOOR</a>,
- <a href="othreps.html#FLOOR">REQFLOOR</a>,
- <a href="othreps.html#FLOOR">DIRFLOOR</a>,
- <a href="othreps.html#FLOOR">TYPEFLOOR</a>,
- <a href="othreps.html#FLOOR">REDIRFLOOR</a>,
- <a href="othreps.html#FLOOR">FAILFLOOR</a>,
- <a href="othreps.html#FLOOR">REFFLOOR</a>,
- <a href="othreps.html#FLOOR">REFSITEFLOOR</a>,
- <a href="othreps.html#FLOOR">SEARCHQUERYFLOOR</a>,
- <a href="othreps.html#FLOOR">SEARCHWORDFLOOR</a>,
- <a href="othreps.html#FLOOR">REDIRREFFLOOR</a>,
- <a href="othreps.html#FLOOR">FAILREFFLOOR</a>,
- <a href="othreps.html#FLOOR">FULLBROWFLOOR</a>,
- <a href="othreps.html#FLOOR">BROWFLOOR</a>,
- <a href="othreps.html#FLOOR">OSFLOOR</a>,
- <a href="othreps.html#FLOOR">VHOSTFLOOR</a>,
- <a href="othreps.html#FLOOR">USERFLOOR</a>,
- <a href="othreps.html#FLOOR">FAILUSERFLOOR</a>,
- <a href="othreps.html#FLOOR">STATUSFLOOR</a></kbd>
-
- <dt><i>Commands (lower levels)</i>
- <dd><kbd>
- <a href="hierreps.html#ARGSFLOOR">REQARGSFLOOR</a>,
- <a href="hierreps.html#ARGSFLOOR">REDIRARGSFLOOR</a>,
- <a href="hierreps.html#ARGSFLOOR">FAILARGSFLOOR</a>,
- <a href="hierreps.html#ARGSFLOOR">REFARGSFLOOR</a>,
- <a href="hierreps.html#ARGSFLOOR">REDIRREFARGSFLOOR</a>,
- <a href="hierreps.html#ARGSFLOOR">FAILREFARGSFLOOR</a>,
- <a href="hierreps.html#SUBFLOOR">SUBDIRFLOOR</a>,
- <a href="hierreps.html#SUBFLOOR">SUBDOMFLOOR</a>,
- <a href="hierreps.html#SUBFLOOR">SUBORGFLOOR</a>,
- <a href="hierreps.html#SUBFLOOR">SUBTYPEFLOOR</a>,
- <a href="hierreps.html#SUBFLOOR">SUBBROWFLOOR</a>,
- <a href="hierreps.html#ARGSFLOOR">SUBOSFLOOR</a>,
- <a href="hierreps.html#SUBFLOOR">REFDIRFLOOR</a></kbd>
-
- <dt><i>Syntax</i>
- <dd><kbd>
- partdate := ["+" | "-"] digit digit
- <br>date := partdate partdate partdate [":" partdate partdate]
- <br>COMMAND number ("r" | "p")
- <br>COMMAND number ["k" | "M" | "G" | "T"] "b"
- <br>COMMAND real ("%" | ":") ("r" | "p" | "b")
- <br>COMMAND date "d"
- <br>COMMAND "-" number ("r" | "p" | "b" | "d")</kbd>
-
- <dt><i>Notes</i>
- <dd>Actually, this syntax isn't quite correct. <kbd>REQFLOOR</kbd>,
- <kbd>TYPEFLOOR</kbd>, <kbd>REQARGSFLOOR</kbd> and <kbd>SUBTYPEFLOOR</kbd>
- aren't allowed to be of type <kbd>"p"</kbd>; and <kbd>REDIRFLOOR</kbd>,
- <kbd>FAILFLOOR</kbd>, <kbd>REDIRREFFLOOR</kbd>, <kbd>FAILREFFLOOR</kbd>,
- <kbd>FAILUSERFLOOR</kbd>, <kbd>STATUSFLOOR</kbd>, <kbd>REDIRARGSFLOOR</kbd>,
- <kbd>FAILARGSFLOOR</kbd>, <kbd>REDIRREFARGSFLOOR</kbd> and
- <kbd>FAILREFARGSFLOOR</kbd> aren't allowed to be of types <kbd>"p"</kbd> or
- <kbd>"b"</kbd>.
-
- <dt><i>Examples</i>
- <dd><kbd>
- TYPEFLOOR -20r
- <br>REQARGSFLOOR 0.1%b
- </kbd>
- </dl>
-
- <h3><a name="quicklinks">Hyperlinks</a></h3>
-
- <dl>
- <dt><i>Syntax</i>
- <dd><kbd>
- <a href="include.html#LINKINCLUDE">LINKINCLUDE</a> *file
- <br><a href="include.html#LINKINCLUDE">LINKEXCLUDE</a> *file
- <br><a href="include.html#LINKINCLUDE">REFLINKINCLUDE</a> *referrer
- <br><a href="include.html#LINKINCLUDE">REFLINKEXCLUDE</a> *referrer
- <br><a href="othreps.html#BASEURL">BASEURL</a> prefix_string</kbd>
- <dt><i>Examples</i>
- <dd><kbd>
- LINKINCLUDE pages
- <br>REFLINKINCLUDE *.cgi
- <br>BASEURL http://www.mycompany.com
- </kbd>
- </dl>
-
- <h3><a name="quicklang">Language commands</a></h3>
- <dl>
- <dt><i>Syntax</i>
- <dd><pre>
- <a href="output.html#LANGUAGE">LANGUAGE</a> ("ARMENIAN" | "BOSNIAN" | "CATALAN" | "SIMP-CHINESE" |
- "TRAD-CHINESE" | "CZECH" | "DANISH" | "DUTCH" | "ENGLISH" |
- "US-ENGLISH" | "FINNISH" | "FRENCH" | "GERMAN" | "GREEK" |
- "ITALIAN" | "JAPANESE" | "NORWEGIAN" | "NYNORSK" | "POLISH" |
- "PORTUGUESE" | "BR-PORTUGUESE" | "RUSSIAN" | "SERBIAN" | "SLOVAK" |
- "SLOVENE" | "SPANISH" | "SWEDISH" | "TURKISH" | "UKRAINIAN")
- <a href="output.html#LANGUAGE">LANGFILE</a> localfile
- <a href="domfile.html">DOMAINSFILE</a> localfile
- </pre>
- <dt><i>Notes</i>
- <dd><a href="output.html#LANGUAGE">Other languages</a> were available in
- <a href="http://www.statslab.cam.ac.uk/~sret1/analog/">version 3</a> of analog,
- and should be available for version 4 soon.
- <dt><i>Examples</i>
- <dd><kbd>
- LANGUAGE ITALIAN
- <br>LANGFILE lang/hindi.lng
- </kbd>
- </dl>
-
- <h3><a name="quickcosmetic">Cosmetic and miscellaneous commands</a></h3>
-
- <dl>
- <dt><i>Syntax</i>
- <dd><kbd>
- <br><a href="output.html#outstyle">OUTPUT</a> ("HTML" | "ASCII" | "COMPUTER" | "NONE")
- <br><a href="output.html#GOTOS">GOTOS</a> ("ON" | "OFF" | "FEW")
- <br><a href="output.html#RUNTIME">RUNTIME</a> ("ON" | "OFF")
- <br><a href="output.html#LASTSEVEN">LASTSEVEN</a> ("ON" | "OFF")
- <br><a href="output.html#REPORTORDER">REPORTORDER</a> perm("xcmdDhH45WriSoEItzsfKkuJvbB")
- <br><a href="output.html#IMAGEDIR">IMAGEDIR</a> URL
- <br><a href="output.html#NOROBOTS">NOROBOTS</a> ("ON" | "OFF")
- <br><a href="output.html#LOGO">LOGO</a> (URL | "none")
- <br><a href="output.html#HOSTNAME">HOSTNAME</a> string
- <br><a href="output.html#HOSTNAME">HOSTURL</a> (URL | "none")
- <br><a href="output.html#HEADERFILE">HEADERFILE</a> (localfile | "none")
- <br><a href="output.html#HEADERFILE">FOOTERFILE</a> (localfile | "none")
- <br><a href="output.html#STYLESHEET">STYLESHEET</a> (URL | "none")
- <br><a href="output.html#SEPCHAR">SEPCHAR</a> (char | "none")
- <br><a href="output.html#SEPCHAR">REPSEPCHAR</a> (char | "none")
- <br><a href="output.html#SEPCHAR">DECPOINT</a> char
- <br><a href="compout.html">COMPSEP</a> string
- <br><a href="output.html#RAWBYTES">RAWBYTES</a> ("ON" | "OFF")
- <br><a href="output.html#PAGEWIDTH">HTMLPAGEWIDTH</a> number
- <br><a href="output.html#PAGEWIDTH">ASCIIPAGEWIDTH</a> number
- <br><a href="timereps.html#BARSTYLE">BARSTYLE</a> ("a" | "b" | "c" | "d" | "e" | "f" | "g" | "h")
- <br><a href="timereps.html#MARKCHAR">MARKCHAR</a> char
- <br><a href="timereps.html#MINGRAPHWIDTH">MINGRAPHWIDTH</a> number
- <br><a href="timereps.html#WEEKBEGINSON">WEEKBEGINSON</a> ("SUNDAY" | "MONDAY" | "TUESDAY" | "WEDNESDAY" | "THURSDAY" | "FRIDAY" | "SATURDAY")
- <br><a href="args.html#SEARCHENGINE">SEARCHENGINE</a> *referrer comma-separated-strings
- </kbd>
- <dt><i>Examples</i>
- <dd>Too many to list. See the documentation on each individual command.
- </dl>
-
- <h3><a name="quickdebug">Diagnostics</a></h3>
-
- <dl>
- <dt><i>Syntax</i>
- <dd><kbd>
- <a href="syntax.html#settings">SETTINGS</a> ("ON" | "OFF")
- <br><a href="debug.html#debugs">DEBUG</a> ("ON" | "OFF" | ["+" | "-"] subset("CDFSU"))
- <br><a href="debug.html#WARNINGS">WARNINGS</a> ("ON" | "OFF" | ["+" | "-"] subset("CDEFLMR"))
- <br><a href="debug.html#PROGRESSFREQ">PROGRESSFREQ</a> number
- <br><a href="debug.html#ERRFILE">ERRFILE</a> localfile
- <br><a href="debug.html#ERRLINELENGTH">ERRLINELENGTH</a> number</kbd>
- <dt><i>Examples</i>
- <dd><kbd>
- DEBUG ON
- <br>DEBUG CF
- <br>WARNINGS -DL
- <br>PROGRESSFREQ 50000
- </kbd>
- </dl>
-
- <hr>
- <address><a HREF="http://www.statslab.cam.ac.uk/~sret1/">Stephen Turner</a>
- <br>Need help with analog? <a href="mailing.html">Subscribe to the analog-help
- mailing list</a>
- </address>
- <p>
- [ <a href="Readme.html">Top</a> | Up | Prev | Next |
- <a href="map.html">Map</a> | <a href="indx.html">Index</a> ]
- </body> </html>
-